home *** CD-ROM | disk | FTP | other *** search
/ Mac-Source 1994 July / Mac-Source_July_1994.iso / Other Langs / Tickle-4.0 (tcl) / library / help / tcl / files / fstat < prev    next >
Encoding:
Text File  |  1993-10-26  |  2.2 KB  |  60 lines  |  [TEXT/$Tcl]
  1.  
  2.  
  3.           fstat fileId ?item?|?stat arrayvar?
  4.                Obtain status information about an open file.
  5.  
  6.                The following keys are used to identify data items:
  7.  
  8.                o atime - The time of last access.
  9.  
  10.                o ctime - The time of last file status change
  11.  
  12.                o dev - The device containing a directory for the file.
  13.                This  value  uniquely  identifies  the file system that
  14.                contains the file.
  15.  
  16.                o gid - The group ID of the file's group.
  17.  
  18.                o ino - The inode number.  This field uniquely  identi-
  19.                fies the file in a given file system.
  20.  
  21.                o mode - The mode of the file  (see  the  mknod  system
  22.                call).
  23.  
  24.                o mtime - Time when the data in the file was last modi-
  25.                fied.
  26.  
  27.                o nlink - The number of links to the file.
  28.  
  29.                o size - The file size in bytes.
  30.  
  31.                o tty - If the file is associated with a terminal, then
  32.                1 otherwise 0.
  33.  
  34.                o type - The type of the file in symbolic  form,  which
  35.                is  one  of  the  following  values:  file,  directory,
  36.                characterSpecial, blockSpecial, fifo, link, or socket.
  37.  
  38.                o uid - The user ID of the file's owner.
  39.  
  40.                If one of these keys is specified as  item,  then  that
  41.                data item is returned.
  42.  
  43.                If stat arrayvar is specified, then the information  is
  44.                returned  in  the  array  arrrayvar.  Each of the above
  45.                keys indexes an element of  the  array  containing  the
  46.                data.
  47.  
  48.                If only fileId is specified, the  command  returns  the
  49.                data as a keyed list.
  50.  
  51.                The following value may be returned only if  explicitly
  52.                asked  for,  it  will not be returned with the array or
  53.                keyed list forms:
  54.  
  55.                o remotehost - If fileId is a TCP/IP socket connection,
  56.                then  a  list  is returned with the first element being
  57.                the remote host IP address.  If the  remote  host  name
  58.                can  be  found, it is returned as the second element of
  59.                the list.
  60.